Annotate gtk_text_child_anchor_get_widgets() correctly
authorEmmanuele Bassi <ebassi@gnome.org>
Wed, 6 May 2020 18:31:07 +0000 (19:31 +0100)
committerEmmanuele Bassi <ebassi@gnome.org>
Wed, 6 May 2020 22:09:53 +0000 (23:09 +0100)
We switched from returning a list to returning a C array, which means we
need to update the introspection annotation and the documentation to
match the implementation.

gtk/gtktextchild.c

index fb2b0f14c8588a0edeb88dca4f49edb7759e285e..9ef3184673517c6b1cdbd61b33f154c169539028 100644 (file)
@@ -432,10 +432,11 @@ gtk_text_child_anchor_finalize (GObject *obj)
  * @anchor: a #GtkTextChildAnchor
  * 
  * Gets a list of all widgets anchored at this child anchor.
- * The returned list should be freed with g_list_free().
  *
+ * The order in which the widgets are returned is not defined.
  *
- * Returns: (element-type GtkWidget) (transfer container): list of widgets anchored at @anchor
+ * Returns: (array length=out_len) (transfer container): an
+ *   array of widgets anchored at @anchor
  **/
 GtkWidget **
 gtk_text_child_anchor_get_widgets (GtkTextChildAnchor *anchor,